home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / Freeware / Remapollo / RemAPollo.doc < prev    next >
Text File  |  2002-10-27  |  34KB  |  812 lines
  1.                                 RemAPollo V1.7
  2.  
  3.                        Eccentric Creations (TM) Product
  4.  
  5.                  (c) Mikolaj Calusinski 1998-2002. Freeware.
  6.  
  7.                                  User Manual
  8.  
  9. Introduction
  10. ------------
  11.  
  12. RemAPollo - 040\060 MMU Apollo Turboboard Remapper is freeware but copyrighted
  13. software. It has been written as a result of my depression arising from the
  14. sad fact that no working MMU remapper program was available for Apollo board.
  15. We, Apollo users, were in worse position than our Blizzard owning friends;
  16. they are able to modify their Kickstart ROMs as easily as setting one jumper
  17. on their board. We couldn't do that - our boards have no dedicated jumpers and
  18. there were no software to support us in our Kickstart changing needs. But,
  19. hopefully, this inequality will end now thanks to RemAPollo.
  20.  
  21. Please, notice the fact, that although RemAPollo is no longer BETA, bugs are
  22. always possible. Please contact me in case of any trouble caused by remapper;
  23. detailed bug reports are welcome. For contact address see 'Author' section
  24. below. Also, be sure to carefully read this manual!
  25.  
  26. Distribution
  27. ------------
  28.  
  29. RemAPollo package may be distributed freely, providing the following criteria
  30. are met:
  31.  
  32.  - None of the files in the RemAPollo distribution archive may be modified or
  33.    omitted.
  34.  
  35.  - No money is charged for it apart from media and small handling fee.
  36.  
  37.  - RemAPollo package may be included in freely distributable software
  38.    libraries, but it CANNOT appear on commercial CD-ROMs (including all kind
  39.    of coverdiscs). If you want to include RemAPollo on your CD-ROM you must
  40.    ask for my permission first. This does not apply to AminetCD series;
  41.    Administrator of Aminet, Urban MÜller, has my full permission to place
  42.    RemAPollo package on AminetCD.
  43.  
  44.  - RemAPollo may not be bundled with any commercial hardware or software
  45.    product without prior written consent from me.
  46.  
  47. Disclaimer
  48. ----------
  49.  
  50. YOU USE RemAPollo FILES TOTALLY ON YOUR OWN RISK. I TAKE NO RESPOSIBILITY FOR
  51. ANY DAMAGE CAUSED BY USING RemAPollo PACKAGE.
  52.  
  53. What is that actually for?
  54. --------------------------
  55.  
  56. RemAPollo is a software package for users of Amiga 1200 computer equipped with
  57. 040/060 Apollo Turboboard. It consists of a few files which can be used to
  58. remap ROM part of Amiga Operating System, known as Kickstart, to fast memory
  59. and boot the computer from it. You can move your physical ROM to fast memory
  60. just to gain more speed or you can use wholely different Kickstart image
  61. (especially useful if you are a developer). For more details see Usage
  62. section.
  63.  
  64. Files
  65. -----
  66.  
  67. RemAPollo package consists of the following files:
  68.  
  69. - 68060.pch - patch file for 68060.library, version 60.02 to version 60.10
  70.  
  71. - Converter - command used to convert BlizKick modules (of no patch type) to
  72.   RemAPollo compatible format.
  73.  
  74. - CopyIDEfixPrefs - a little command used to copy new IDEFix prefs file to
  75.   IDEfix executable. Can be used by those who want to load IDEfix via MODULES
  76.   option of RemAPollo
  77.  
  78. - DRAP - Apollo Remapper Deallocator
  79.  
  80. - ExecP - small Kickstart45 revision fixer; use it with exec module from OS
  81.   3.9 BB2 (corrects Kickstart revision number as shown f.ex. in WB/About req)
  82.  
  83. - FakeLOCAL - this hackish program is to force Apollo fast memory attributes
  84.   to report LOCAL bit set (on 3.x Kickstart also KICK bit is set) on
  85.   coldstart. Thanks to it most of the residents will load itself to fastmem.
  86.   NOTE: This is a HACK and can be used ONLY along with RemAPollo program! For
  87.   experienced users ONLY! You should well understand meaning of LOCAL bit to
  88.   use this! Beware!
  89.  
  90. - KReader - a short command for saving current Kickstart to file
  91.   ram:Kickstart. Now it has been enhanced with 'F' option which should be used
  92.   if you want to be sure that Kickstart will be saved directly from chips.
  93.  
  94. - LoadResident - CLI command for loading/unloading or listing of resident
  95.   modules; can be used to add/remove files to resident list without the need
  96.   of re-running RemAPollo.
  97.  
  98. - Modules/fixramlib - module to correct bug in KS 2.x in ramlib subsystem;
  99.   allows oparation of resident AFTERDOS modules (eg. HappyENV-handler module).
  100.   You don't need this for Kickstart 3.x
  101.  
  102. - Modules/fixramlib.s - source code to this module
  103.  
  104. - Modules/HappyConfig - special command which allows passing startup options
  105.   for HappyENV-handler module. Usage: 'HappyENV-handler,TO,STARTUP/K/F:',
  106.   where: first argument specifies location of HappyENV-handler module (default
  107.   is L:), TO specifies name of modified handler and STARTUP keyword is used
  108.   for entering startup options of the handler. Full list of available options
  109.   and their explanation can be found in original HappyENV guide. To remove all
  110.   the options just do not specify STARTUP argument. Examples:
  111.   'HappyConfig STARTUP NOREQ' - instructs the handler to stay silent on
  112.   unrecognized/unsupported packets
  113.   'HappyConfig' - removes all options
  114.  
  115. - Modules/HappyENV-handler - improved verion for this known handler originally
  116.   written by Martin Gierich, in version 1.3 which supports resident
  117.   installation
  118.  
  119. - Modules/KingCON-handler.pch - spatch patch for KingCON-handler 1.3, 020+
  120.   version to make KingCON resident installable (thus replacing original
  121.   con-handler completely)
  122.  
  123. - Modules/MountENV - improved version of MountENV command
  124.  
  125. - Modules/noclick - updated version of BlizKick patch module, which turns off
  126.   floppy drive clicking
  127.  
  128. - Modules/noclick.s - source code to this module
  129.  
  130. - MuDRAP - Apollo Remapper Deallocator for use with 68040/060.library from
  131.   mmu.library package
  132.  
  133. - patch - special patcher for 68040/60.library
  134.  
  135. - RemAPollo - main remaper program
  136.  
  137. - RemAPollo.doc - this doc
  138.  
  139. - RemAPollo.doc.info
  140.  
  141. - RemAPollo.doc.pl - Polish version of manual
  142.  
  143. - RemAPollo.doc.pl.info
  144.  
  145. - RemAPollo.info - cute icon (by my brother Jack :)
  146.  
  147. - RemAPollo.readme - short Aminet description
  148.  
  149. - Reset - reset tool
  150.  
  151. - RUX - OS3.5/3.9 ROM Update eXtractor - a little command supporting "one
  152.   reset at cold boot" OS3.5/3.9 installation (also see Additional Notes
  153.   section)
  154.  
  155. Copyrights
  156. ----------
  157.  
  158. Amiga, AmigaOS and Kickstart are Copyright © 1985-1999 Amiga International,
  159. Inc.
  160. BlizKick is Copyright © 1996-2000 PitPlane Productions.
  161. Fusion is Copyright ©1997 By Jim Drew & Microcode Solutions
  162. HappyENV-handler is Copyright 1995-1997 Martin Gierich
  163. IDEfix is Copyright 1993 - 1999 Elaborate Bytes, Oliver Kastl.
  164. KingCON-handler is Copyright © 1993,1994 David Larsson
  165. mmu.library project © 1998-2000 the mmu.library development group, THOR
  166. RemAPollo is Copyright © 1998-2000 Mikolaj Calusinski.
  167. ShapeShifter is © Copyright 1993-1999 Christian Bauer.
  168. spatch is Copyright © 1992 SAS Institute, Inc.
  169.  
  170. Requirements
  171. ------------
  172.  
  173. For proper operation of RemAPollo package you require:
  174.  
  175. - an Amiga 1200 or 4000
  176.  
  177. - at least 2.0 (V36) Kickstart in ROM (this should not be a problem :-)
  178.  
  179. - Apollo 040 or 060 Turboboard (the processor must have fully working MMU)
  180.   loaded with at least 1MB of fast memory
  181.  
  182. - original 040.library from Commodore in versions 37.10 or 37.30 (or OS3.5
  183.   44.2) if you are using 68040 processor or 060.library supplied with the
  184.   board (currently only version 60.10 is supported) if you are using 68060
  185.   processor.
  186.  
  187.  
  188. Installation
  189. ------------
  190.  
  191. Installation, however simple, requires some steps which should be followed
  192. strictly and carefully, else system will almost certainly cause you trouble.
  193. As RemAPollo is not for absolute beginners, there is no installation script
  194. provided - you are required to do all the work by hand.
  195.  
  196.                                       1.
  197.  
  198. First - and this is VERY important - you should patch 040(060).library. In
  199. RemAPollo package there is a special program for this purpose called 'patch'.
  200. If your 040(060).library is located in LIBS: and is not crunched (as it should
  201. be in normal setup) all you have to do is type in a shell window command
  202. 'patch' without any parameters. The program will inform you about results of
  203. its work. Please note that for 68040 processor only original libraries from
  204. Commodore are supported; if you are using newer 3rd party library (probably
  205. from Phase5) you will need to stop to do so or RemAPollo will not work. There
  206. is really no need to use Phase5's libraries with Apollo board, believe me;
  207. they were designed for Blizzard turbos.
  208.  
  209. If your library is crunched, first decrunch it and invoke 'patch' program with
  210. path parameter pointing to this decrunched library. After patch is done you
  211. can recrunch library again.
  212.  
  213. This patch is ABSOLUTELY necessary if you want your system to boot reliably
  214. with mapped Kickstart. Your Amiga may seem to work well without the patch but
  215. this is simply asking yourself for trouble; sooner or later your system may
  216. crash. If you want to know further details see Additional notes section.
  217.  
  218. Some older versions of Apollo060 came with 68060.library in version 60.02
  219. sadly not supported by my patch program (which requires at least 60.10). To
  220. aid users of such a board I included special patch '68060.pch', which should
  221. be applied to the library using SAS/C freely distributable 'spatch' program.
  222. First patch your 68060.library to version 60.10 and then use my patch program
  223. on it.
  224.  
  225.                                       2.
  226.  
  227. After above patch is done, you should copy command 'DRAP' (Apollo Remapper
  228. Deallocator) to your C: directory. Till the version of 1.11 you had to place
  229. a call for it in the very first line just after SetPatch in your
  230. startup-sequence. Since the version 1.12 of DRAP this is no longer required;
  231. you can invoke it whenever you want - preferably as a first command. Here
  232. comes recommended beginning of startup-sequence:
  233.  
  234. ...
  235. DRAP
  236. If WARN
  237. RemAPollo MAC QUIET
  238. EndIf
  239. SetPatch QUIET
  240. ...
  241.  
  242. This little program is not absolutely necessary for proper operation of system
  243. with remapped Kickstart but its use is very strongly encouraged. It will free
  244. some memory used by remapper during boot (67720 bytes to be exact) and
  245. generally restore the system to more stable and efficient state. If you intend
  246. to use MAC patch (see Usage) this program *MUST* be run or Fusion will crash.
  247. Its use will also speed up system a bit as it moves first page of memory,
  248. which contains absolute location 4 and happens to be in slooow chip mem, to
  249. fast memory. Finally, DRAP will writeprotect mapped Kickstart. You can keep
  250. its invocation in startup-sequence all the time - even when you want to boot
  251. directly from your ROM Kickstart without the help of remapper - as it will do
  252. exactly nothing (except setting return code to 5 [WARN]) while relocation is
  253. not active.
  254.  
  255. As of version 1.8 there is a little more control over DRAP activities. You can
  256. invoke it without any parameters (recommended) or you can issue any
  257. combination of two new switches: ND=NODEALLOC or RH=RESTOREHANDLER.
  258.  
  259. The first one is used to prevent DRAP from deallocating memory (67720 bytes)
  260. used for temporary MMU tables. These tables are no longer needed as soon as
  261. 68040.library installed its own MMU tree, so most of the time you should not
  262. specify this switch. However if you think you cannot live without a statram
  263. ramdisk (SDx:) or have problems with improperly written resident software
  264. (SIMBug is a good example) you should use NODEALLOC. You will not get back
  265. 67720 bytes of fast memory (who cares these times) but your SD0 will work as
  266. usual.
  267.  
  268. The second parameter (RESTOREHANDLER) can be specified to order DRAP to
  269. restore original value of CPU Bus-Error handler. This is not recommended,
  270. since after using this switch all attempts of writing to ROM area (which is
  271. stupid BTW, but can happen accidentally) will cause a GURU on normal setup
  272. (without Enforcer running).
  273.  
  274. As of version 1.12 a slightly new way of initialization has been introduced to
  275. DRAP - it can now open 68040\60.library, so there is now no requirement to
  276. load it after SetPatch. Also, a new NR (NOREMAP) switch has been added; it can
  277. be used to switch off remapping of zero memory page from chip to fast ram.
  278. Additionally improved compatibility of this operation. See bugs section for
  279. more explanation.
  280.  
  281.                                       3.
  282.  
  283. When two above steps are completed, you can finally use the remapper itself.
  284. See Usage.
  285.  
  286.  
  287. Relocation will survive between resets as long as exec base remains valid and
  288. ColdCapture vector is not changed. To get rid of the resident and return to
  289. original ROM Kickstart just use supplied 'Reset' command with HARD parameter.
  290. It will clear execbase pointer thus removing all resident code from your
  291. system.
  292.  
  293. From RemAPollo version 1.6 new, more convenient method of selfremoval has been
  294. introduced. You must have three button mouse for this to work - if you want to
  295. remove relocation just keep MMB (Middle Mouse Button) pressed during reset.
  296. The screen should turn red and the relocation will be removed.
  297.  
  298. Usage
  299. -----
  300.  
  301. RemAPollo main program can be invoked from both environments: CLI and WB.
  302. WB tooltypes are almost identical to CLI parameters, so let's discuss the
  303. latter.
  304.  
  305. Standard template (can be obtained via use of question mark) looks like this:
  306.  
  307. KICKFILE,MAC/S,NF=NOPAGEFIX/S,REBFIX/S,IMJ/S,FORCE/S,QUIET/S,
  308. USE=USEKICKPTRS/S,MODULES/K/F:
  309.  
  310. None of parameters is required. If you do not supply any parameters, current
  311. ROM Kickstart will be remapped, patched and the computer will perform reset.
  312. You will boot with the same Kickstart as in ROM, but with one very useful
  313. difference: remapper patches Kickstart in such a way, that fast memory is
  314. usable to the system very early. Thanks to it exec can use this fast memory
  315. for early initialization, placing there own library base and supervisor
  316. stack, so you no longer need patches like FastExec. Additionally you are able
  317. to mount recoverable ramdrives (RADs) in fast memory!
  318.  
  319. KICKFILE parameter is used to specify location of optional Kickstart image
  320. file you want your computer to boot from and operate on. Only 512KB images
  321. with $1114 header or 256KB images with $1111 header and a correct checksum are
  322. supported. Since release 1.4 RemAPollo can be used to remap pre-2.0 (256KB)
  323. Kickstarts.
  324.  
  325. Since version 0.994 of RemAPollo Kickstart files can be compressed.
  326. Decompression is done via xfdmaster.library so make sure you have installed it
  327. if you want to pack your Kick files.
  328.  
  329. MAC - use this switch to reserve first 16KB of chip memory as required by
  330. Fusion, Apple Macintosh software emulator for Amiga. You will not need to use
  331. any RsrvCold, RsrvWarm or PrepareEmul-like tools in your startup-sequence
  332. then. Naturally, this switch allows proper operation of ShapeShifter as well.
  333. Do not forget to run 'DRAP' command after SetPatch though!
  334.  
  335. NF or NOPAGEFIX - this parameter is only useful with 2.x Kickstart images; on
  336. versions 3.x is completely ignored. It is used to switch off fixing of the
  337. first memory page performed automatically on 2.x Kickstarts by remapper. On
  338. those Kickstarts, chip memory is linked to system memlist from location $400.
  339. Because 040/060 processors have MMU page resolution of at least 4kb, it is
  340. better to start chip memory from adequately aligned location such as $1000.
  341. Mapper does this by properly fixing exec initialization routines; starting
  342. from Kickstart 3.0 the fix is no longer necessary as it is performed already
  343. by Kickstart itself. If, for some reason, you do not want to change original
  344. behaviour of 2.x Kickstarts regarding chip memory init, specify NOPAGEFIX.
  345. This parameter is overridden by the use of MAC switch.
  346.  
  347. FORCE - specify this if you want to remap Kickstart in spite of the fact, that
  348. relocation is already active. Normally, remapper will not try to start mapping
  349. process when it detects that this has been done already (so you can use mapper
  350. in your startup-sequence without looping reboots).
  351.  
  352. QUIET - ideal option for those, who want to use remapper permanently in
  353. startup-sequence. It stops all text output from RemAPollo and shortens delay
  354. before rebooting.
  355.  
  356. ---> As of version 1.2 a new IMJ option has been added; it can be used to
  357. disable MEM jumper of the board (so the fast memory always will be visible).
  358.  
  359. ---> As of version 1.6 a new REBFIX option has ben added; use this special
  360. switch if you have problems with cards in ZORROII extension board. Due to
  361. Apollo bug, sometimes there are problems with AutoConfig(TM) protocol - this
  362. switch attempts to correct them but because of its hackish nature use it ONLY
  363. if you have problems.
  364.  
  365. You can abort remapping process while not in quiet mode by pressing standard
  366. CTRL-C break.
  367.  
  368. *****************************************************************************
  369. **** WARNING! THE FOLLOWING SECTION IS FOR ADVANCED USERS ONLY! WARNING! ****
  370. *****************************************************************************
  371.  
  372. ---> As of version 0.980ß a new MODULES option has been added:
  373.  
  374. MODULES - this keyword can be used to specify optional files, you want to make
  375. resident in one go with the Kickstart. If used, it *MUST* appear as a very
  376. last option in commandline. The number of files is limited only by available
  377. memory (and commandline length). You can supply here any file, which contains
  378. a valid resident ROMTAG structure (for example: most libraries and
  379. filesystems). Additionally, it can be used to make IDEFix reset resident (see
  380. Bugs section for some oddities).
  381.  
  382. From version 0.996 you can use BlizKick modules with RemAPollo! These come in
  383. two types: patch and extresbuf. Patch ones can be applied directly using
  384. MODULES option, while extresbuf-type require converting prior to installation.
  385. Use supplied program 'Converter' to fix them.
  386.  
  387. From version 1.2 you are no longer required to enter full path to modules each
  388. time if they are located in the same directory. For example let's assume you
  389. want to load three BlizKick modules located in DEVS:Mods/ directory. In old
  390. versions you had to type something like this:
  391.  
  392. "...MODULES DEVS:Mods/noclick DEVS:Mods/FixMath404 DEVS:Mods/ramlibstack"
  393.  
  394. Since 1.2 version you must enter the path only first time:
  395.  
  396. "RemAPollo MODULES DEVS:Mods/noclick FixMath404 ramlibstack"
  397.  
  398. ---> As of version 0.991ß a new USEKICKPTRS option has been added:
  399.  
  400. USE or USEKICKPTRS - this switch forces remapper to use current KickTag and
  401. KickMem residents list. Thanks to this option you can use other resident
  402. programs and still have only one reset at coldstart. To make this work you
  403. have to run these additional programs BEFORE RemAPollo and you should
  404. configure them to not perform reset! For exaple - if you need to use
  405. BootControl proram by Oliver Kastl and want to have only one reboot at start,
  406. you should place the following in your startup-sequence:
  407.  
  408. BootControl INSTALL        ;NOTE: there's no 'BOOT' switch used!
  409. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;USE makes the mapper see BootControl
  410. SetPatch QUIET
  411. DRAP
  412. ...
  413.  
  414. Please note that all the residents installed this way will be placed in LOCAL
  415. memory which on most systems means chip memory. To overcome this I wrote a
  416. little hack program, called FakeLOCAL. This program should be placed as a
  417. very first command in your startup-sequence, so the above example will look
  418. like this:
  419.  
  420. FakeLOCAL
  421. BootControl INSTALL        ;NOTE: there's no 'BOOT' switch used!
  422. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;USE makes the mapper see BootControl
  423. SetPatch QUIET
  424. DRAP
  425. ...
  426.  
  427. Now, the BootControl program will load into Apollo fast memory.
  428.  
  429. NOTE: FAkeLOCAL is a HACK and can be used ONLY along with RemAPollo program!
  430. For experienced users ONLY! You should well understand meaning of LOCAL bit to
  431. use this! Beware!
  432.  
  433. *****************************************************************************
  434. *****************************************************************************
  435. *****************************************************************************
  436.  
  437. If you need an example - I use the following phrases in start of my
  438. startup-sequence:
  439.  
  440. DRAP
  441. If WARN
  442. FakeLOCAL    ;I use this only because of MountCD below!
  443. MountCD CD0 QUIET
  444. RemAPollo MAC QUIET USE MODULES C:IDEfix L:KingCON-handler FastFileSystem
  445. EndIf
  446. SetPatch QUIET
  447.  
  448. I have 3.1 ROMs so no need to specify Kickstart image, but if you use 3.0, you
  449. can issue something like this:
  450.  
  451. RemAPollo DEVS:Kickstart3.1 MAC QUIET MODULES c:IDEFix L:FastFileSystem
  452.  
  453. Of course, you must have appropriate Kickstart image file in DEVS: to do this.
  454.  
  455. Additional Notes
  456. ----------------
  457.  
  458. Resident code of RemAPollo is protected with checksum to assure proper booting
  459. - program will turn the screen red and hard reset the machine when any change
  460. in resident segment is found.
  461.  
  462. Mapper uses ColdCapture vector to survive between reboots, so you should not
  463. run any other programs which make use of this vector. Also, CPU Bus Error
  464. vector ($00000008) is replaced and should remain in this state until SetPatch
  465. opens 68040(60).library. After that you should run DRAP command which restores
  466. this vector to original (NOTE: as of version 1.8 of DRAP the vector is not
  467. restored by default. You can force its restoration by 'DRAP RH'). Take above
  468. facts into account when examining system with antivirus program.
  469.  
  470. To allow Kickstart mapping, RemAPollo must build MMU translation tables which
  471. consume some memory. I tried to limit amount of this memory as much as
  472. possible, so mapper uses 8KB MMU pages. Unfortunately, this design conflicts
  473. with the way Commodore's 040.library and Apollo's 060.library install their
  474. own 4K tables. These libraries do not switch MMU off before loading root
  475. pointers resulting in unpredictable system behaviour. Look at this code from
  476. 040.library in version 37.30:
  477.  
  478. (following routine is entered with enabled MMU in 8K mode, as done by mapper)
  479.  
  480.     ori.w    #$700,SR
  481.     pflusha
  482.     move.l    (A0)+,D0
  483.     movec    D0,URP        ;!!! URP points to 4K tables!!!
  484.     move.l    (A0)+,D0
  485.     movec    D0,SRP        ;!!! SRP points to 4K tables!!! - BOOOM!
  486.     move.l    (A0)+,D0
  487.     movec    D0,TC        ;MMU is switched to 4K mode, little late...
  488.     pflusha
  489.     moveq    #0,D0
  490.     movec    D0,ITT0
  491.     movec    D0,ITT1
  492.     movec    D0,DTT0
  493.     movec    D0,DTT1
  494.     rte
  495.  
  496. To work properly, above routine should start with something like this...
  497.  
  498.     ori.w    #$700,SR
  499.     moveq    #0,d0
  500.     movec    d0,TC        ;switch MMU off
  501.     pflusha
  502.  
  503. ...and that's exactly what does the 'patch' program.
  504.  
  505. NOTE: If you are going to remap Kickstart from file, please make sure you have
  506. a proper version of it! The file must contain image of Kickstart which is in
  507. original, unmodified form and designed to work on your computer. So, if you
  508. have an Amiga A1200, RemAPollo cannot be used with A4000's (40.7x) kickfiles.
  509.  
  510.                                      ***
  511.  
  512. OS3.5/3.9 users, read below:
  513.  
  514. You have probably wondered if RemAPollo could be used with OS 3.5/3.9 updates.
  515. Fear not, it can. All versions of RemAPollo are compatible with the latest OS
  516. updates and there should be no problems with possible future OS releases.
  517. However, newer releases of RemAPollo go even further to aid you with
  518. transparent OS3.5/3.9 installation. There is a special 'RUX' tool included,
  519. which can be used to extract some OS3.5/3.9 modules from file 'AmigaOS ROM
  520. Update' (usually placed in DEVS:) obsoleting default SetPatch installation.
  521. RUX comes with the following command line options:
  522.  
  523. FILE,A600/S,A1200/S,A3000/S,A4000I/S,A4000S/S
  524.  
  525. FILE - specifies location of 'AmigaOS ROM Update' file (default is to search
  526. in DEVS:)
  527.  
  528. Other switches denote type of machine modules are to be extracted for:
  529.  
  530. A600 - you should never specify this switch, as these modules are designed to
  531.        be compatible with 68000 CPU
  532. A1200 - most of the time this should be the switch of your choice
  533. A3000 - for Amiga 3000
  534. A4000I - for Amiga 4000 if you use only its embedded IDE interface
  535. A4000S - for Amiga 4000T with real SCSI controller
  536.  
  537. So, after using default OS3.5/3.9 installer, you can make the following
  538. corrections:
  539.  
  540. 1. make a directory in your LIBS: named, say, OS3.5
  541. 2. move workbench.library and icon.library from LIBS: to LIBS:OS3.5/
  542. 3. remember to MOVE them (so make sure they are not visible in LIBS:)
  543. 4. assuming you have A1200 and 'AmigaOS ROM Update' file is placed in DEVS:,
  544. open yur shell, change current directry to LIBS:OS3.5/ and enter 'RUX A1200'
  545. 5. some files will be created, named OS_ModuleX, where 'X' is a successive
  546. module number; these are resident modules you should use with MODULES option
  547. of Remapollo. If you want to know real name of a module, look at its comment
  548. 6. remove 'AmigaOS ROM Update' file from DEVS: (recommended) or use
  549. NOROMUPDATE option of SetPatch
  550.  
  551. Beginning of your startup-sequence should resemble something like this
  552. (customize this according to your setup and liking of course):
  553.  
  554. DRAP
  555. If WARN
  556. ;--------- the following in one line of course
  557. RemAPollo DEVS:Kick3.1 MAC QUIET MODULES LIBS:OS3.5/OS_Module1 OS_Module2
  558. OS_Module3 workbench.library icon.library
  559. ;---------
  560. EndIf
  561. SetPatch QUIET NOROMUPDATE
  562. ...
  563.  
  564. Usually, you can skip first module (OS_Module1) and in case you use IDEFix or
  565. FastATA (PowerFlyer) also skip scsi.device module. You can tell the actual
  566. module name (and real function) from its comment.
  567.  
  568. Thanks to this installation, you will still have only one reset at coldstart.
  569.  
  570.  
  571.                                      ***
  572.  
  573. MMU.library users can now try (mostly experimental) MuDRAP proggy. If you
  574. think you need to use mmu.library aware 040/060.library, you have to use
  575. MuDRAP instead of regular DRAP command. Due to the way mmu.library works, the
  576. installation of RemAPollo files are slightly different. You should place
  577. RemAPollo BEFORE SetPatch and MuDRAP commands in your startup-sequence and
  578. muDRAP has to be run just AFTER SetPatch:
  579.  
  580. ... RemAPollo <options>
  581. SetPatch
  582. MuDRAP <options>
  583.  ...
  584.  
  585. Note, that you DO NOT need to patch mmu.lib's 68040/060.library!
  586.  
  587. WARNING!: Included MuDRAP version is experimental and should be used ONLY with
  588. 68040/060.library from mmu.lib package!!! Using MuDRAP with any other version
  589. of 68040/060 may yeld undefined results!!!
  590.  
  591.                                      ***
  592.  
  593. Bugs
  594. ----
  595.  
  596. Recoverable ramdisk driven by statram.device (SDx:) will no longer work as
  597. supposed when default installation of RemAPollo has been made. To make it work
  598. again you must invoke DRAP with 'ND' option in startup-sequence. The above
  599. does not apply to users of RemAPollo >1.4 with two separately-configured (non
  600. continuous) fast mem banks on their board.
  601.  
  602. OXYPatcher does not mount its port properly on most systems. It is not my
  603. fault - OXYPatcher is very buggy.
  604.  
  605. As of version 119.11 (3.1) of IDEfix its preferences are no longer stored into
  606. main executable. This is somewhat annoying if you intend to load IDEfix by
  607. MODULES option of RemAPollo. To overcome this I included a little command -
  608. CopyIDEfixPrefs, which copies your prefs from a new SYS:Prefs/IDEfix.prefs
  609. file to the IDEfix executable.
  610.  
  611. I've got several reports stating that RemAPollo does not allow some of old
  612. games to work properly (this applied to so called NDOS-floppy games fixed to
  613. operate on newer CPUs and enhanced with HD loaders). Gfx corruption and
  614. sometimes even crashes were observed. All this mess was caused by DRAP program
  615. default mapping of reserved low chip-memory location to board's fast memory.
  616. Strictly speaking it was not my fault, as no OS-compliant program should use
  617. nonallocated memory. But to enhance compatibility I changed the way DRAP does
  618. the mapping - it should work ok now. If you still experience problems, you can
  619. disable the mapping completely using NR (or NOREMAP) option of DRAP. Please
  620. note howerver, that after using Fusion (Apple Macintosh emulator) you will
  621. have the same problem again, as Fusion remaps whole first 16kb of chip memory
  622. to fastmem by itself. This applies to systems without RemAPollo running as
  623. well.
  624.  
  625.  
  626. History
  627. -------
  628.  
  629. V0.1ALPHA - (??.9.98) - internal hardcoded versions for my own use
  630.  
  631. V0.96ß - (23.12.98) - first semi-public release, to selected betatesters only
  632.  
  633. V0.97ß - (1.1.99) fixes:
  634.  - caches are now invalidated prior enabling
  635.  - only instruction cache is enabled at start
  636.  - resident now checks ROM checksum - hard reset when incorrect
  637.  
  638. V0.973ß - (8.1.99)
  639.  - added fix for $c00000 mem recognition (this should cure yellow-screen
  640.    crashes occuring on some systems). Thanks for Arkadiusz Winiarek and Marcin
  641.    Ostrowski for reporting this.
  642.  
  643. V0.974ß - (12.1.99)
  644.  - added 060 flag to execbase when 060 detected
  645.  
  646. V0.975ß - (13.1.99)
  647.  - better resident code recognition (you can use *polite* programs that grab
  648.    coldcapture vector now). First truly public version.
  649.  
  650. V0.976ß - (26.1.99)
  651.  - changed the header of mapped Kickstart to 'MM' to avoid confusion when
  652.    trying to map Kickstart image processed by Remapollo
  653.  
  654. V0.977ß - (28.1.99)
  655.  - fixed bug in reset routine
  656.  
  657. V0.980ß - (1.2.99)
  658.  - MAJOR: added possibility to install resident modules (like IdeFix, betas
  659.    from AmigaInc., etc.) in one go with the Kickstart
  660.  
  661. V0.981ß - (4.2.99)
  662.  - fixed  mem allocation bugs with modules option
  663.  
  664. V0.982ß - (5.2.99)
  665.  - check for doubling modules
  666.  - some internal changes
  667.  
  668. 0.983ß Thu Feb 11 22:52:40 1999
  669. - WB mode bugs introduced in 0.982 fixed
  670. - added 8 bytes of safety margin to AllocAbs
  671.  
  672. 0.984ß Sun Feb 21 11:26:15 1999
  673. - some serious rewrites to make RA work on A4000 started
  674. - no longer compatible with previous versions (RemAPollo and DRAP)
  675.  
  676. 0.985ß Mon Feb 22 17:42:31 1999
  677. - internal changes in resident segment code
  678. - fixed a few additional serious bugs with MODULES option
  679.  
  680. 0.986ß Fri Mar 05 21:41:59 1999
  681. - fixed serious bug introduced in 0.985 (resident frame)
  682.  
  683. 0.987ß Sat Mar 13 14:41:48 1999
  684. - housekeeping changes & cleanups
  685.  
  686. 0.988ß Mon Mar 15 22:30:16 1999
  687. - housekeeping cleanups
  688. - fixed a long-standing serious bug in bus-error handler (write protect
  689.   violation in Kickstart area caused removal of the mapping)
  690.  
  691. 0.989ß Sat Mar 20 22:01:33 1999
  692. - added special code for A4000 "feature"
  693. - fixed bug in WB mode MODULES option
  694.  
  695. 0.990ß Sun Apr 11 15:19:08 1999
  696. - replaced BSS section by a direct memory allocation
  697.  
  698. 0.991ß Tue Apr 13 15:20:40 1999
  699. - added USEKICKPTRS option
  700.  
  701. 0.993ß Fri Apr 23 21:54:10 1999
  702. - QUIET option is now disabled when fatal error occured
  703. - removed support for A4000 due to technical reasons
  704. - second public Aminet release
  705.  
  706. 0.994ß Wed May 12 13:26:34 1999
  707. - added support for packed Kickfiles (xfdmaster.library)
  708.  
  709. 0.995ß Mon May 17 12:11:18 1999
  710. - rewritten for optimized frames
  711. - again made incompatible with previous releases :)
  712. - restored partial support for A4k; must have first SIMM slot empty for this!
  713.  
  714. 0.996ß Thu Jun 10 11:36:36 1999
  715. - fixed serious bug in 060 version of bus-error handler
  716. - added support for BlizKick modules; patch type only
  717. - fixed bug with modulenames containing space
  718.  
  719. 0.997ß Sun Jun 27 02:24:41 1999
  720. - changed reset routines a little (trying to compensate for Apollo bug)
  721. - rewritten 060 handler; hope this finally fixes all the bugs
  722.  
  723. 1.0 Sun Jul 04 15:44:17 1999
  724. - final (?) release
  725.  
  726. 1.1 Mon Sep 06 22:56:31 1999
  727. - corrected bug with leading spaces in MODULES commandline
  728. - fixed small bugs in resident frame code
  729. - added trace switch for 040 handler and fixed small bug in 060 handler
  730.  
  731. 1.2 Sun Oct 17 17:31:27 1999
  732. - added automatic directory change while loading modules
  733. - fixed bug with modules mem deallocation after ctrl-c
  734. - added IMJ switch
  735.  
  736. 1.3 Sat Dec 25 12:29:54 1999
  737. - restored reset code from 1.0 version; should work with all boards now
  738. - again rewritten parts of bus-error handler
  739.  
  740. 1.4
  741. - MAJOR: added support for Kick1.x
  742. - fixed small bug with modules parser
  743.  
  744. 1.5
  745. - minor bugfix with MODULES option on KS2x
  746. - small fix in 040 bus-error handler
  747. - MMU temp table is now placed starting from lower bank (so SD0: should work
  748.   on systems with non continuous mem banks without 'DRAP ND')
  749.  
  750. 1.6
  751. - fixed serious bug (trashing of pr_Result2 on program fail)
  752. - rearrange Kick fixing code so exec and expansion can now be replaced by
  753.   patch type modules (you can install own exec/expansion libraries!)
  754. - fixed MAC problems with Exec44
  755. - added MMB removal check
  756. - fixed *HORRIBLE* bug in AddMemList() patch code. Fortunately, nobody has
  757.   noticed ;)
  758. - added REBFIX switch for people equipped with ZORRO Micronik boards
  759.  
  760. 1.7
  761.  
  762. - added full support for 'big' Apollos. Finally!
  763. - resident frame is built dynamically now
  764. - enhanced module loader: now it can properly recognize and install files
  765.   consisting of more than one ROMTag
  766. - added support for exec.library installed via KickTags
  767. - MAJOR: fixed very serious bug in 060 MMU tables: lev B pointers were not
  768.   aligned properly
  769.  
  770. Thanks
  771. ------
  772.  
  773. Big thanks must go to Harry Sintonen who sent me some early infos about 040
  774. MMU - it was long ago but they helped me to recognize the problem I intended
  775. to confront with; thanks again mate!
  776.  
  777. Warm kisses to Motorola ;-) for excellent Literature Distribution Center which
  778. provides all the customers with various kinds of printed manuals. For free!
  779. I didn't have to register as a certified developer, issue any monthly fees nor
  780. sign any NDAs just to get access to information. Incredible for people used to
  781. Commodore's policy, but true. ;-)
  782.  
  783. Last (but not least) - thanks to all alfatesters who agreed to risk integrity
  784. of their systems while fighting with numerous versions of RemAPollo
  785. (especially to Marcin Ostrowski for helping me to notice serious bug; hope you
  786. finally will manage to set your system stright again... ;)
  787.  
  788. Special thanks to Olivier Fabre for bugreports and testing new versions of
  789. handler on 060.
  790.  
  791. Very special thanks to Hagen Hagemann for excellent support. :-)
  792.  
  793. Thanks for Rafal Mrozkiewicz and Thomas Richter who help me to realize that
  794. Motorola has increased alignment requirements for MMU descriptors in 68060
  795. CPU.
  796.  
  797. Also I wish to thank my brother Jacek for Polish version of this manual (I'm
  798. so lazy... :)
  799.  
  800. This program is dedicated to Ministry - the band creating music, not (c)rap.
  801.  
  802. Author
  803. ------
  804. My e-mail address (this is preferred way of contact): bloelle@priv.gold.pl or
  805. bloelle@polbox.com
  806.  
  807.  
  808. I hope you find this little proggy useful. Have fun!
  809.                                                             Mike.
  810.  
  811.            ------------> AMIGA - THE BEST COMPUTER EVER <------------
  812.